home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-01 / jjbqc.zip / JJBREAD.ME < prev    next >
Text File  |  1993-01-04  |  14KB  |  383 lines

  1.  
  2.  
  3.    --------------------------------------------------------------------
  4.                  JJBREAD.ME
  5.    --------------------------------------------------------------------
  6.  
  7.  
  8.   Anyone may use JJB without cost or obligation. It is a professional
  9.   product which places the 'C' programmer in a high-level coding
  10.   environment at the same time providing low-level control over your
  11.   program.  Every two or three months, new software will become
  12.   available from JJB.
  13.  
  14.                           jjb
  15.  
  16.  
  17.  
  18. *****************************************************************************
  19. *                                                             version 1.0   *
  20. *                                                                           *
  21. *                                                                           *
  22. *                                 JJB                                       *
  23. *                                                                           *
  24. *                  for Quick C and Turbo C programmers                      *
  25. *                                                                           *
  26. *   JJB is the first in a series of software which allow the C programmer   *
  27. *     to write programs in minutes instead of taking days or even weeks.    *
  28. *                                                                           *
  29. *                                from                                       *
  30. *                                                                           *
  31. *                                JJB                                        *
  32. *                    9236 Church Rd, Suite 1082                             *
  33. *                       Dallas, Tx  75231                                   *
  34. *                         (214) 341-1635                                    *
  35. *                                                                           *
  36. *                                                                           *
  37. * JJB may be freely copied, used and circulated without cost or obligation. *
  38. *                                                                           *
  39. * Copyright (c) 1989, JJB Dallas, Tx.                                       *
  40. * Quick C is a trademark of Microsoft Corp.                                 *
  41. * Turbo C is a trademark of Borland.                                        *
  42. *****************************************************************************
  43.  
  44.  
  45.    What is JJB ?
  46.  
  47.      JJB is an environment the C programmer can use to program any
  48.      application:
  49.  
  50.  
  51.        -JJB allows you to program fast.
  52.  
  53.        -JJB handles routine tasks such option selection, input, etc.
  54.  
  55.        -JJB gives your program a professional appearance.
  56.  
  57.        -JJB provides you with both high-level and low-level control.
  58.  
  59.        -JJB runs on all IBM PC, XT, AT 286, 386 and compatible computers,
  60.              on all MONOCHROME, CGA, EGA, and VGA controllers.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.            --------------------------------
  67.              first in a series
  68.            --------------------------------
  69.  
  70.    JJB is the first in a series of software which enable the programmer
  71.    to become more efficient at the same time giving the programmer more
  72.    high-level and low-level control.
  73.  
  74.  
  75.    This version of JJB is for all Quick C programmers.
  76.  
  77.  
  78.  
  79.            --------------------------------
  80.              JJB handles option selection
  81.            --------------------------------
  82.  
  83.    The heart of JJB is its ability to monitor every keypress in your
  84.    program. No matter where you are in your program, you can press 'ALT'
  85.    and select any option. JJB handles changing options.
  86.  
  87.    You can define options and assign function names to them.
  88.  
  89.    Each option can be initalized and exited with a function.
  90.  
  91.    Options can be grouped together.
  92.  
  93.  
  94.    JJB gives you more control over your program.
  95.  
  96.  
  97.    JJB provides you with necessary low-level functions you need to get
  98.    started. JJB also has high-level functions you can use so you do
  99.    not have to concern yourself with the details.
  100.  
  101.  
  102.  
  103.   *******************************************************************
  104.   *                                                                 *
  105.   * JJB runs on all IBM PC, XT, AT 286, 386 and compatible computers*
  106.   *      and on all MONOCHROME, CGA, EGA, and VGA controllers.      *
  107.   *                                                                 *
  108.   *******************************************************************
  109.  
  110.  
  111.    The JJB functions run on all IBM PC, XT, AT 286, 386 and compatible
  112.    computers and on all video controllers. JJB is designed so that
  113.    the software you write today, will run on computers of the future
  114.    such as the 386 and etc.
  115.  
  116.  
  117.    JJB functions were written to conserve as much memory as possible.
  118.    Only the basic necessary functions are placed in JJB.OBJ. Other
  119.    optional functions are placed in object modules which can be linked.
  120.    Plus, these other functions are completely documented in the printed
  121.    documentation in case you need to change something.
  122.  
  123.  
  124.  
  125.            --------------------------------
  126.              100% control over keyboard
  127.            --------------------------------
  128.  
  129.    JJB gives you absolute 100% control over the keyboard.  The header
  130.    file 'JJBKBD.H' provides you with definitions you can use to test
  131.    for any key on the keyboard.
  132.  
  133.    The niece thing about JJB is that you do not have to use them.
  134.    JJB does all the low-level keyboard testing for you. There is even a
  135.    function which lets you simulate user keypresses from inside your
  136.    program.
  137.  
  138.  
  139.  
  140.            --------------------------------
  141.             video fast   'vf'
  142.            --------------------------------
  143.  
  144.    JJB gives you complete control over video.  The 'vf' functions
  145.    are designed for speed, portability, flexiblity, and ease of use.
  146.  
  147.    For example:   vloc(4,10);
  148.           vfs("Video fast this string");
  149.  
  150.    The above example places a string into direct memory access at row 4,
  151.    column 10.  The 'vf' functions give you speed and control over what you
  152.    want videoed and how you want it to look on the monitor.
  153.  
  154.  
  155.            --------------------------------
  156.                 input & enter
  157.            --------------------------------
  158.  
  159.    The 'input' and 'enter' functions allow you to design input screens
  160.    which have a professional appearance. An entire input screen can be
  161.    programmed in less than 10 minutes, and these functions even have the
  162.    ability to edit for input ranges of numbers.
  163.  
  164.  
  165.    The 'input' and 'enter' functions have been designed so that you can
  166.    create you own 'enter' functions.
  167.  
  168.  
  169.  
  170.            --------------------------------
  171.                printed documentation
  172.            --------------------------------
  173.  
  174.    A printed manual is available from JJB for #35.  Anyone may order it
  175.    and it will be shipped the next day.
  176.  
  177.    The printed manual documents in detail over 80 hidden functions.
  178.    The hidden functions provide you with a very tight and powerful set
  179.    of routines.
  180.  
  181.    The functions were written to be appreciated by the advanced programmer
  182.    who requires tight, fast and portable code. But they can also be used
  183.    by the beginning programmer who needs a simple and easy way to program.
  184.  
  185.  
  186.  
  187.            --------------------------------
  188.             JJB hidden library
  189.            --------------------------------
  190.  
  191.    The object file JJB.OBJ contains the hidden library. To conserve memory,
  192.    it was compiled using only two include files:
  193.  
  194.         #include <dos.h>
  195.         #include <setjmp.h>
  196.  
  197.    Any of the functions in the library can be used after you use the
  198.    function jjb_initalize() in your program . There are undoubtly some
  199.    very good programmers out there who will figure out how to look at the
  200.    file and get some of the function names without having the manual. A
  201.    hint is that all of the fast direct memory access functions begin
  202.    with 'v', and 'vf' stands for video fast.
  203.  
  204.  
  205.    ------------------------ hidden library includes ---------------------
  206.  
  207.    A comprehensive set of video fast functions which
  208.       runs on all IBM PC, XT, AT 286,386 and compatible computers
  209.        and on all MONOCHROME, CGA, EGA, and VGA controllers.
  210.    A complete set of keyboard, input, and enter functions including the
  211.       ability of simulate keypresses from inside your program.
  212.    Extremely high speed windowing ability and many more features which
  213.        every programmer needs in order to efficiently produce programs.
  214.  
  215.    The printed documentation of the hidden library throughly explains what
  216.    each function does and gives you many examples of how to use them.
  217.  
  218.    ----------------------------------------------------------------------
  219.  
  220.  
  221.            --------------------------------
  222.              future JJB software
  223.            --------------------------------
  224.  
  225.    JJB S&W (Strings & Windows) will be available in the spring of 1989.
  226.  
  227.    JJB LA (Large Application) is the third in the JJB series and is
  228.    scheduled for release in the summer of 1989.
  229.  
  230.    Also in 1989 will be released 'JJB IO' (input and output for DOS).
  231.    This software will allow you to easily create and update large data bases
  232.    and be able to access any record in a fraction of a second.
  233.  
  234.  
  235.  
  236.  
  237.            --------------------------------
  238.                GETTING STARTED WITH JJB
  239.            --------------------------------
  240.  
  241.  
  242.    If you have the JJB files on floppy diskette and you have
  243.    Quick C from Microsoft Corporation, you can begin using JJB.
  244.  
  245.  
  246.    Place the diskette with the JJB files in drive a:   and:
  247.  
  248.  
  249.     enter 'JJBATOC'       to copy all JJB files to c:\bin
  250.  
  251.     enter 'JJBGO'         to create the JJB.QLB (quick library)
  252.  
  253.  
  254.    In order to write programs, you need to create the JJB quick
  255.    library 'JJB.QLB'.  The .bat file 'JJBGO.BAT' does this for you.
  256.    It requires you have QUICKLIB.OBJ on drive c:\lib. If so, it will
  257.    create the JJB quick library 'JJB.QLB'.
  258.  
  259.  
  260.    This version of JJB is for Quick C. Turbo C will soon be released.
  261.  
  262.    Once you have created the JJB quick library, you can compile and
  263.    execute source files JJBSHOW1.C thru JJBSHOW5.C.  These files are
  264.    examples of how to use JJB when you begin writing programs.
  265.  
  266.  
  267.    Remember, the concept of JJB is to provide you with an environment
  268.    in which you can write programs 'FAST'. Therefore, the JJB functions
  269.    are designed for high-level programming while at the same time giving
  270.    you low-level control over your program.
  271.  
  272.  
  273.    JJBSHOW5.C is a good example of this. This example shows you how you
  274.    can write an entire input screen.  While entering data, the user of
  275.    your program can use the UP or DOWN ARROWS going to any input line on
  276.    the screen.
  277.  
  278.  
  279.    While entering any data, the user can also press 'ALT' and select
  280.    any option in your program. If another option is selected, JJB will
  281.    leave the current option and execute the new one.
  282.  
  283.  
  284.    Let's look at the first example of JJB  'JJBSHOW1.C'.
  285.  
  286.  
  287.     To begin, from DOS enter: 'JJBS1'.
  288.  
  289.     You should now be in Quick C looking at  'JJBSHOW1.C'.
  290.  
  291.     If you have any problems, see the 'problems' section below.
  292.  
  293.  
  294.  
  295.            --------------------------------
  296.                   JJB files
  297.            --------------------------------
  298.  
  299.     JJBREAD.ME      ( this file )
  300.     JJBATOC.BAT     ( copies all JJB files from drive a: to c:\bin )
  301.     JJBGO.BAT       ( creates the JJB quick library 'JJB.QLB' )
  302.  
  303.     JJBGLOSS.DOC    ( glossary of JJB functions )
  304.  
  305.     JJB.EXE         ( a JJB demo          )
  306.  
  307.     JJB.OBJ         ( the JJB object file )
  308.     JJBINPUT.OBJ    ( the object file for input & enter functions)
  309.     JJBDOLLR.OBJ    ( the object file for input dollar functions )
  310.  
  311.     JJB.QLB         ( the JJB quick library created with JJBGO.BAT)
  312.  
  313.     JJBKBD.H        ( keyboard definitions plus documentation )
  314.     JJBSET.H        ( get( & set( definitions and documentation)
  315.  
  316.  
  317.  
  318.     JJBSHOW1.C      ( examples of how to begin using JJB )
  319.     JJBSHOW2.C      ( examples of how to begin using JJB )
  320.     JJBSHOW3.C      ( examples of how to begin using JJB )
  321.     JJBSHOW4.C      ( examples of how to begin using JJB )
  322.     JJBSHOW5.C      ( examples of how to begin using JJB )
  323.  
  324.     JJBS1.BAT       ( use to enter Quick C and load JJBSHOW1.C )
  325.     JJBS2.BAT       ( use to enter Quick C and load JJBSHOW2.C )
  326.     JJBS3.BAT       ( use to enter Quick C and load JJBSHOW3.C )
  327.     JJBS4.BAT       ( use to enter Quick C and load JJBSHOW4.C )
  328.     JJBS5.BAT       ( use to enter Quick C and load JJBSHOW5.C )
  329.  
  330.  
  331.            --------------------------------
  332.                   JJB demo
  333.            --------------------------------
  334.  
  335.   The file JJB.EXE is a JJB demo. It is not really a demo because JJB
  336.   is an environment to use and is not an end product in itself.
  337.  
  338.   From DOS enter 'JJB' and you will get some idea of how your pull-down
  339.   menus will look if you use JJB to write your program. The demo also
  340.   shows you its tremendous speed and powerful set of functions.
  341.  
  342.  
  343.  
  344.            --------------------------------
  345.                  problems
  346.            --------------------------------
  347.  
  348.    This section trys to clear up problems you may have loading or executing
  349.    the JJBSHOW source files.
  350.  
  351.  
  352.    All the files in this version use Quick C from Microsoft Corp. If you
  353.    do not have Quick C, you can not complile and execute. You can, however,
  354.    run 'JJB.EXE' by entering 'JJB' from DOS.
  355.  
  356.  
  357.    The bat file JJBATOC.BAT assumes you have a hard disk in drive c:.
  358.    If not, move the JJB files to the Quick C  subdirectory \bin.
  359.    For example:  a:>copy jjb*.* b:\bin
  360.  
  361.  
  362.    The bat file JJBGO.BAT assumes the file QUICKLIB.OBJ is in the Quick C
  363.    subdirectory '\lib'. If not, change the bat file so that it is
  364.    referencing the proper subdirectory where it can find the Quick C
  365.    object library.
  366.  
  367.  
  368.    Entering 'qc jjbshow1.c' will not work.
  369.  
  370.    You need to include the JJB quick library as follows from DOS:
  371.  
  372.  
  373.         QC /l JJB.QLB JJBSHOW1.C
  374.  
  375.  
  376.    The bat file 'JJBS1.BAT' does this.   Enter 'JJBS1' from DOS.
  377.  
  378.  
  379.    --------------------------------------------------------------------
  380.             end of file: JJBREAD.ME
  381.    --------------------------------------------------------------------
  382.  
  383.